home *** CD-ROM | disk | FTP | other *** search
/ Educational Software Cooperative 4 / Educational Software Cooperative 4.iso / quiz303 / quiz.par < prev    next >
Text File  |  1996-01-30  |  18KB  |  436 lines
  1.  
  2. Command line options:
  3.  
  4.      The "command line" refers to what was typed at the  DOS
  5. prompt to start the Create A Quiz program.  For example,  if
  6. your Create A Quiz disk is located in drive A:, your  screen
  7. should display an  "A>" prompt.   When you type  the letters
  8. "QUIZ" before  you press  the [ENTER]  key, you  are at  the
  9. "command line".
  10.  
  11.      Additional text  can be  appended to  the command  line
  12. after the key word "QUIZ"  that will instruct Create A  Quiz
  13. to perform certain functions not available through the  menu
  14. selections.
  15.  
  16.      Please  note  that  the   following  options  are   NOT
  17. available in the "Lite" version  of Create A Quiz.   Command
  18. line  options  are  only   available  in  the  full-featured
  19. Teacher's and Student's versions.
  20.  
  21.  
  22.      QUIZ filename.QZ
  23.  
  24.      If  a  name  of  an  existing  .QZ file is added on the
  25. command line after the key  word "QUIZ", then that .QZ  file
  26. will  be  automatically  presented  to  the  user  once  the
  27. program  starts.   In  such  cases  the  "Main Menu" will be
  28. skipped, and the  student will be  greeted with a  prompt to
  29. enter his name, followed by the quiz.  In the above  example
  30. replace  the  word  "filename"  with  the actual name of the
  31. quiz you  wish to  use.   If your  quiz is  called "MATH.QZ"
  32. then  you  must  enter  "QUIZ MATH.QZ"  on the  command line
  33. before  running  the  program.
  34.  
  35.      Command line instructions can be combined or placed  in
  36. any  order.   In  other  words,  the  following command line
  37. instructions are all acceptable:
  38.  
  39.      QUIZ TIMEOUT=10 QTY=20
  40.  
  41.      The  command  line  instructions  above  will cause the
  42. program to end after 10 minutes of play have  elapsed or  20
  43. random questions have been attempted, whichever comes first.
  44.  
  45.      The remainder of the command line options are listed
  46. below in ALPHABETICAL order:
  47.  
  48. ------------------------------------------------------------
  49.  
  50.      QUIZ CONFIRM
  51.  
  52.      For those  student of  yours who  are heavy  handed, or
  53. all  thumbs,  you  can  give  them the opportunity to change
  54. their answer/response to a  quiz by adding the  command line
  55. parameter "CONFIRM".   After the student  selects/inputs his
  56. response,  a  confirmation  window  will  appear  asking the
  57. student if he is sure that he wants to accept his  response,
  58. with an option to return to the question and choose/input  a
  59. different  answer.   After  the  student  has  confirmed his
  60. response, his response will be judged "Correct" or "Wrong".
  61.  
  62.  
  63.      QUIZ DISPLAY filename.QZ
  64.  
  65.      The above command line instructions force Create A Quiz
  66. into a continuous loop  using "filename.QZ".  When  a player
  67. is prompted for his name,  the program will insist that  the
  68. user input his FULL name, AND address, city, state, zip  and
  69. phone  number  before  they  can  participate  in  the  quiz
  70. specified  by  "filename.QZ".   This  "DISPLAY" command line
  71. instruction  (with  .QZ  file)  turns  Create A Quiz into an
  72. excellent  sales  or  promotional  tool  for  businesses and
  73. organizations.  For example,  a company that specializes  in
  74. selling  and  installing  home  water  filters  can create a
  75. "WATER.QZ" file that  presents several questions  that tests
  76. a  prospective  client's  knowledge  of tap water, chlorine,
  77. heavy metals, cost comparisons, etc.   If Create A Quiz  has
  78. been  started  with  the  "WATER.QZ  DISPLAY"  command  line
  79. instructions,  then  WATER.QZ  will  be  presented  to  each
  80. client  that  approaches  the  company's  computer  display.
  81. Each user's  name and  address are  stored in  a file called
  82. "USER.LST".  The "USER.LST" file can later be retrieved  and
  83. used to print  out mailing labels  or possible client  list.
  84. Should you  wonder how  to stop  Create A  Quiz from looping
  85. into eternity  in the  "DISPLAY" mode,  enter "GOODBYE" when
  86. the input window prompts for a user's full name.  Of  course
  87. you  could  reboot  your  computer,  but  that's  not   very
  88. graceful...
  89.  
  90.  
  91.      QUIZ ENFORCE QTY=15
  92.  
  93.      The  command  line  parameter  "ENFORCE" when used with
  94. "STOPAT=" or "STARTAT=" or "QTY=" parameters will prevent  a
  95. student from  exiting the  program/quiz until  the specified
  96. range or quantity of questions have been attempted.
  97.  
  98.  
  99.      QUIZ FIBCHAR=x
  100.  
  101.      The way Create A Quiz determines whether a question  is
  102. a multiple-choice  or fill-in-the-blank  type is  by use  of
  103. the  underscore  "_"  character.   If  an  "_"  appears in a
  104. question (anywhere) then  that question is  assumed to be  a
  105. multiple-choice  type  question.   However,  there are times
  106. where  you  would  prefer  to  have  a  different  character
  107. determine  this,  therefore  use  the FIBCHAR=x command line
  108. parameter  where  "x"  is  replaced  with  the actual single
  109. character  that  will  determine   whether  a  question   is
  110. fill-in-the-blank or not.
  111.  
  112.  
  113.      QUIZ LOGFILE=xxxx
  114.  
  115.      The command line  parameter LOGFILE=xxxx will  save ALL
  116. questions  and  choices  presented  to  the student, AND the
  117. student's response.   Replace "xxxx" with  a legal DOS  file
  118. name.   Included  in  this  log  file  will be the student's
  119. name,  quiz  name,  date,  time,  and a summary of attempts,
  120. correct responses, etc.
  121.  
  122.  
  123.      QUIZ LOG1ST
  124.  
  125.      The  command   line  parameter   LOG1ST  is   used   in
  126. conjunction with  the QUIZ.WHO  file (see  advanced features
  127. section).   LOG1ST  will  cause  the  student  input  prompt
  128. window to appear only once EVER.  If the student attempts  a
  129. second quiz on another day, there will be no expanded  input
  130. prompts  to  greet  them  (asking  for address, city, phone,
  131. whatever...).   How  does  the  program  know  whether   the
  132. student is using  the program for  the first time?   Because
  133. when  LOG1ST  is  used,  it  will  automatically  delete the
  134. QUIZ.WHO file if it exists.   Since the QUIZ.WHO is used  to
  135. determine what input prompts  are displayed, if it  does not
  136. exist, then no expanded prompts will appear.  So in  review,
  137. LOG1ST with a  QUIZ.WHO file will  cause an expanded  player
  138. input field  window to  display the  first time  the student
  139. uses a  quiz.   The program  will then  automatically delete
  140. the  QUIZ.WHO  file,  which  means  any  future  uses of the
  141. program will  NOT display  an expanded  player input  prompt
  142. window.
  143.  
  144.  
  145.      QUIZ LPT=filename
  146.  
  147.      This  parameter  allows  you  to  redirect printouts of
  148. quizzes  (from the  editor) to  an ASCII  disk file by using
  149. the command line parameter LPT=filename.  Replace "filename"
  150. with a legal DOS file name.
  151.  
  152.  
  153.      QUIZ NAME=xxxx
  154.  
  155.      This parameter allows you to pass the name of a  single
  156. student/user to Create  A Quiz.   By passing this  value the
  157. "Please  enter  your  name:"  prompt  will not appear when a
  158. student selects a quiz.  Example:   QUIZ NAME=MIKE   If  the
  159. name you are using consists of more than one name, then  use
  160. an underscore character "_"  to connect each name  (example:
  161. QUIZ NAME=MIKE_R._JONES).
  162.  
  163.  
  164.      QUIZ NODOC
  165.  
  166.      This  parameter  is  only  valid  with  the   STUDENT'S
  167. EDITION of Create A Quiz.   This will prevent access to  the
  168. on-screen  documentation  file   (what  you  are   currently
  169. reading).
  170.  
  171.  
  172.      QUIZ NODUPES
  173.  
  174.      The   command   line   instruction   above when used in
  175. conjunction with  random question  mode will  insure that no
  176. duplicating  questions  will  be  given  to the student.  In
  177. other words,  each question  presented to  the student  will
  178. appear only once (i.e., no duplicates).
  179.  
  180.  
  181.      QUIZ NOEDIT     * Not currently available
  182.  
  183.      The  NOEDIT  command  line  parameter  will  remove the
  184. "Create" and  "Edit" selections  from the  Main Menu  in the
  185. Teacher's Edition.   This is used  when you want  to prevent
  186. students from accessing or tampering with your quizzes.
  187.  
  188.  
  189.      QUIZ NOOPTS
  190.  
  191.      This command line parameter will suppress/withhold  the
  192. "Play Options  Menu".   This will  prevent the  student from
  193. changing  the  question  order,  printout,  or repeat errors
  194. options.   You  canNOT  currently  combine  the  NOOPTS  and
  195. RESTRICT  (see  above)  parameters,   since  some  form   of
  196. introductory menu will always be necessary.
  197.  
  198.  
  199.      QUIZ NOPCT
  200.  
  201.      The  teacher  can  customize  what  appears  on the top
  202. status  line  with  the  command  line parameters "NOPCT" or
  203. "NOSTATS".  The former will display the following:
  204.  
  205. ┌─────────────────────── WHO'S WHO ────────────────────────┐
  206. │ Name: James                 Attempts: 4     Left: 3      │
  207. └──────────────────────────────────────────────────────────┘
  208.  
  209. If you wish to suppress all of the status line use "NOSTATS"
  210. and you will instead have the following header:
  211.  
  212. ┌──────────────────────────────────────────────────────────┐
  213. │              WHO'S WHO - LESSON 1 - FAMOUS MEN           │
  214. └──────────────────────────────────────────────────────────┘
  215.  
  216.  
  217.      QUIZ NOQS
  218.  
  219.      Adding the command line parameter "NOQS" will turn  off
  220. the  familiar  ?  ¿  wallpaper  symbols  that  appear on the
  221. screen.
  222.  
  223.  
  224.      QUIZ NOREVIEW
  225.  
  226.      When a student takes a quiz in which a  multiple-choice
  227. question  is  presented,  the  student  has to select from a
  228. list of possible correct answers.  If the student picks  the
  229. wrong answer, the message "xyz IS INCORRECT!" At this  point
  230. the student may still not know the correct answer.  Also  at
  231. this  point  an  instruction  prompt  at  the  bottom of the
  232. screen offers the  student to reveal  the answer (or  review
  233. the choices) by  pressing the [R]  key.  Should  the teacher
  234. wish to withhold this  prompt, and prevent the  student from
  235. discovering the correct answer  he missed, add the  NOREVIEW
  236. parameter on the command line when starting Create A Quiz.
  237.  
  238.  
  239.      QUIZ NOSCORE
  240.  
  241.      If you  DON'T want  your students'  progress or  scores
  242. recorded via  the scoreboard,  add "NOSCORE"  to the command
  243. line.
  244.  
  245.  
  246.      QUIZ PLAYERS=1
  247.  
  248.      If you would like to  skip over the "How many  students
  249. are participating?:"  prompt when  your users  begin using a
  250. quiz (particularly when ONLY  ONE USER would ever  be taking
  251. your quiz), then specify  the number of participants  on the
  252. command line  with "PLAYERS=x"  where "x"  is replaced  with
  253. actual number of participants.
  254.  
  255.  
  256.      QUIZ QTY=x
  257.  
  258.      The above  "QTY=" command  line option  can be  used to
  259. force Create  A Quiz  to stop  and return  to DOS  after "x"
  260. number  of  random  questions  have  been  attempted  by the
  261. student.  You can replace  the "x" with any positive  number
  262. that you wish.  For example, "QUIZ QTY=20".
  263.  
  264.  
  265.      QUIZ REFNOTES
  266.  
  267.      The parameter REFNOTES  will AUTOMATICALLY display  any
  268. EXTENDED LENGTH reference notes  that are associated with  a
  269. question during  play after  the student  has entered  their
  270. answer.  Any  reference notes will  be displayed in  a full-
  271. screen window for easier reading.   If REFNOTES is not  used
  272. (default),  then  the  student  taking  a  quiz will have to
  273. press the [D]  key to manually  display any extended  length
  274. reference notes.
  275.  
  276.  
  277.      QUIZ RESTRICT filename.QZ
  278.  
  279.      The  additional  word  "RESTRICT"  on  the command line
  280. will  prevent  the  student/user  from  reaching  the  "Main
  281. Menu".  This  is useful if  you have given  the program disk
  282. to  a  student and have  created a batch  file to force  the
  283. student to use  a particular quiz,  but you do  not want the
  284. student to gain  access to the  "Main Menu" where  he may be
  285. able  to  change  your  questions  or  answers,  or peek and
  286. cheat.
  287.  
  288.  
  289.      QUIZ SCOREALL
  290.  
  291.      The student taking a quiz will be allowed to  determine
  292. whether they  want their  scores recorded  to the scoreboard
  293. when they are finished.  If the teacher wishes to  eliminate
  294. this option, forcing the  student's score to be  compared to
  295. the  top  10  scoreboard  instead,  then  add  the  SCOREALL
  296. paramenter.  Although SCOREALL will not guarantee that  your
  297. student's  score  will  be  added  to  the  top  10, it will
  298. guarantee that  the student's  score will  be compared  with
  299. the current scoreboard.  If you want to guarantee that  your
  300. student's score is recorded  to the scoreboard, then  delete
  301. the  *.SCB  scoreboard  file  before  taking  the  quiz.  By
  302. deleting  the  appropriate   *.SCB  scoreboard  file,   your
  303. student's  score   will  definitely   be  recorded   in  the
  304. scoreboard since there  will be no  other scores to  compete
  305. against.
  306.  
  307.  
  308.      QUIZ SCORELOG=ON
  309.  
  310.      Since  the  scoreboard  only  records  the  top 10 high
  311. scores, there may be times when your student/user obtains  a
  312. score worth knowing about and  yet falls short of making  it
  313. into the "top  ten" scoreboard.  To maintain a record log of
  314. your  user's  scores  (regardless  of  the  score),  use the
  315. "SCORELOG=ON" parameter.  This  will cause Create A  Quiz to
  316. maintain a file with all user's scores, along with date  and
  317. quiz used.  The file  generated will be straight ASCII  text
  318. and will automatically be named "SCORE.LOG".
  319.  
  320.  
  321.      QUIZ SCRAMBLE
  322.  
  323.      When taking  a multiple  choice quiz,  you will  notice
  324. that  the  "pick  list"  of  possible answer choices appears
  325. exactly in  the same  order as  the answers  were entered by
  326. the teacher  when first  creating that  question.   In other
  327. words, if a multiple choice question exists where...
  328.  
  329.        Question: How much is 1 + 1?
  330.  
  331.        Answer: 2
  332.        Answer: 4
  333.        Answer: 6
  334.        Answer: 8
  335.        Answer: 11
  336.  
  337. ...when  your  student  is presented this  question within a
  338. quiz on the screen,  the order of answers  "2,4,6,8,11" will
  339. be  identical  to  the  order  in  which the teacher entered
  340. them.   If,  however,  you  would  like  to see the order of
  341. answers SCRAMBLED up, then  add the "SCRAMBLE" command  line
  342. parameter when starting QUIZ.  The scramble that will  occur
  343. will vary from moment to  moment, so that if a  question was
  344. to reappear twice, the  order of answers would  be different
  345. from the first appearance.
  346.  
  347.  
  348.      QUIZ STARTAT=10 STOPAT=20
  349.  
  350.      The  above  combination  of  "STARTAT="  and  "STOPAT="
  351. commands  instruct  Create  A  Quiz  to  start at a specific
  352. question  number   and  to   display  subsequent   questions
  353. sequentially  (10,  11,  12,...19,  20).   Once  the  number
  354. designated by  "STOPAT=" is  reached, the  program will exit
  355. to  DOS.   If  you   use  "STARTAT="  without  a   "STOPAT="
  356. statement, Create A Quiz  will still proceed with  questions
  357. sequentially  until  the  very  last  question is reach, and
  358. then will terminate.
  359.  
  360.  
  361.      QUIZ SURVEY
  362.  
  363.      Create  A  Quiz  can  be  transformed  into  "Create  A
  364. Survey", with  the command  line parameter  "SURVEY".   What
  365. this  parameter  does  is  turn  off  all  scoring (no score
  366. header, no scoreboard), and  records all responses from  the
  367. student during a  quiz in an  ASCII file "RECORD.LOG".   The
  368. student's name, the quiz, the date and time, in addition  to
  369. all the  responses to  the questions  are maintained  in the
  370. RECORD.LOG file on the default disk.  There are no right  or
  371. wrong answer messages displayed when "SURVEY" is used.
  372.  
  373.  
  374.      QUIZ TIMEOUT=x
  375.  
  376.      The above  "TIMEOUT=" command  line option  can be used
  377. to force Create A Quiz to  stop and return to DOS after  "x"
  378. number of minutes have elapsed since the first question  was
  379. attempted by the student.  You can replace the "x" with  any
  380. positive  number  that  you   wish.   For  instance,   "QUIZ
  381. TIMEOUT=5" will cause the program to end after 5 minutes  of
  382. play have elapsed.
  383.  
  384.  
  385.      QUIZ 4AGRADE
  386.  
  387.      If you as a teacher would like to grade your  students'
  388. knowledge of a quiz  but do not want  them to know how  they
  389. scored,  then  use  the  command  line  parameter "4AGRADE".
  390. This command will instruct Create A Quiz to 1) suppress  the
  391. "Correct" or "Wrong" result  window; 2) suppress the  status
  392. header  from  displaying  "Correct:"  and  "Percent:".   The
  393. teacher will find the student's answers/repsonses in a  file
  394. called  "RECORD.LOG"  and  their  scores  in the "SCORE.LOG"
  395. file.
  396.  
  397. ------------------------------------------------------------
  398.  
  399.      With  all  the  above   command  line  parameters   now
  400. available, it can  get very crowded  at the DOS  prompt when
  401. you try to  create a custom  environment for your  students.
  402. To eliminate the lengthy DOS command line startup, the  user
  403. can  now  create  a  QUIZ.CFG  file and enter the parameters
  404. into that file  rather than type  the parameters at  the DOS
  405. prompt.  Here's an example...  Instead of typing...
  406.  
  407. QUIZ TESTME.QZ NODUPES STARTAT=1 SCRAMBLE
  408.  
  409. ...at the  DOS prompt  you can  create an ASCII file, and on
  410. line #1 of the QUIZ.CFG file place just the following text:
  411.  
  412. TESTME.QZ NODUPES STARTAT=1 SCRAMBLE
  413.  
  414.      Next time when you  start the program (just  type QUIZ)
  415. the  QUIZ.CFG  will  be  looked  for,  and if it exists, the
  416. first line will be loaded and the parameters used.
  417.  
  418.      If you wish to  ENCRYPT your QUIZ.CFG file,  to prevent
  419. users from modifying your setup, you can accomplish this  by
  420. starting the  Teacher's version  with the  following command
  421. line:  QUIZ ENCRYPT QUIZ.CFG
  422.  
  423.      The above  command will  automatically invoke  Create A
  424. Quiz and instruct it to take the existing QUIZ.CFG file  and
  425. rewrite it to disk  as a READ-ONLY, ENCRYPTED  QUIZ.CFG file
  426. (with CRC  verification), and  then exit  the program.   The
  427. next time you type "QUIZ", the encrypted QUIZ.CFG file  will
  428. then be used.
  429.  
  430.      If you  attempt to  delete an  encrypted QUIZ.CFG file,
  431. you will be  unsucessful, since it  is READ-ONLY.   You must
  432. reset  the  file  attribute  with  DOS'  ATTRIB  -R QUIZ.CFG
  433. command.  Once reset, you  can then delete the QUIZ.CFG  and
  434. create a new one.
  435.  
  436.